﻿<!DOCTYPE html>
<html>
	<head>
		<title>RANDARRAY Function</title>
		<meta charset="utf-8" />
		<meta name="description" content="" />
		<link type="text/css" rel="stylesheet" href="../../../../../../common/main/resources/help/editor.css" />
		<link type = "text/css" rel = "stylesheet" href = "../../images/sprite.css" />
        <script type="text/javascript" src="../callback.js"></script>
        <script type="text/javascript" src="../search/js/page-search.js"></script>
	</head>
	<body>
		<div class="mainpart">
			<div class="search-field">
				<input id="search" class="searchBar" placeholder="Search" type="text" onkeypress="doSearch(event)">
			</div>
			<h1>RANDARRAY Function</h1>
			<p>The <b>RANDARRAY</b> function is one of the <a href="../UsageInstructions/InsertFunction.htm#mathtrigonometry" onclick="onhyperlinkclick(this)">math and trigonometry functions</a>. It is used to return an array of random numbers and can be configured to fill a certain number of rows and columns, set a range for values, or return whole/decimal numbers.</p>
			<h3>Syntax</h3>
			<p><b><em>RANDARRAY([rows], [columns], [min], [max], [whole_number])</em></b></p>
			<p>The <b>RANDARRAY</b> function has the following arguments:</p>
			<table style="width: 40%">
                <tr>
                    <th style="background-color: #f4f4f4" width="150ch"><b>Argument</b></th>
                    <th style="background-color: #f4f4f4"><b>Description</b></th>
                </tr>
                <tr>
                    <td><b><em>rows</em></b></td>
                    <td>An optional argument indicating the number of rows to be returned. If the argument is not given, the function will return a value between 0 and 1.</td>
                </tr>
				<tr>
                    <td><b><em>columns</em></b></td>
                    <td>An optional argument indicating the number of columns to be returned. If the argument is not given, the function will return a value between 0 and 1.</td>
                </tr>
				<tr>
                    <td><b><em>min</em></b></td>
                    <td>An optional argument indicating the minimum number to be returned. If the argument is not given, the function will default to 0 and 1.</td>
                </tr>
				<tr>
                    <td><b><em>max</em></b></td>
                    <td>An optional argument indicating the maximum number to be returned. If the argument is not given, the function will default to 0 and 1.</td>
                </tr>
				<tr>
                    <td><b><em>whole_number</em></b></td>
                    <td>An optional TRUE or FALSE argument. If TRUE, the function will return a whole number; FALSE will return a decimal one.</td>
                </tr>
            </table>
			
			<h3>Notes</h3>
			<p>Please note that this is an array formula. To learn more, please read the <a href="../UsageInstructions/InsertArrayFormulas.htm" onclick="onhyperlinkclick(this)">Insert array formulas</a> article.</p>
			<p><a href="../UsageInstructions/InsertFunction.htm#applyfunction" onclick="onhyperlinkclick(this)">How to apply</a> the <b>RANDARRAY</b> function.</p>
			
			<h3>Examples</h3>
            <p>The figure below displays the result returned by the <b>RANDARRAY</b> function.</p>
			<p><img alt="RANDARRAY Function" src="../images/randarray.png" /></p>
		</div>
	</body>
</html>